home *** CD-ROM | disk | FTP | other *** search
/ Aminet 34 / Aminet 34 (2000)(Schatztruhe)[!][Dec 1999].iso / Aminet / util / cli / JazTools.readme < prev    next >
Encoding:
Text File  |  1999-11-06  |  11.1 KB  |  293 lines

  1. Short:    Iomega JAZ tools
  2. Author:   thor@math.tu-berlin.de (Thomas Richter)
  3. Uploader: thor@math.tu-berlin.de (Thomas Richter)
  4. Version:  0.20
  5. Type:     util/cli
  6. Requires: Os 2.04, A jaz drive (guess what...)
  7.  
  8.  
  9. This program provides functions available thru the Iomega "JazTools" on
  10. Mac and PC, like setting the spindown delay, ejection of cartridges and
  11. more. Unlike the ZJTools, this program really works within its 
  12. specifications... (-:
  13. _____________________________________________________________________________
  14.  
  15. This is a beta release. Actually, everything works as it should, and every-
  16. thing has been tested, but the program is still somewhat incomplete. Since
  17. I do not own a JAZ drive, I need your help!
  18.  
  19. What's to be done:    Options to format a drive, and to test it, like
  20.             in the "real" tools.
  21. _____________________________________________________________________________
  22.  
  23. Announcement:    JAZ drivers for the Amiga.
  24.  
  25. If there is enough interest, I will write a more complete JAZTools program
  26. than this, including a disk driver, a small JAZ-optimized disk cache, im-
  27. plementing JAZ specific functions more JAZ-compliant than this product.
  28. More specifically, the "write verify" will be implemented correctly, the
  29. spindown timer will work correctly, and you'll see a graphical user inter-
  30. face for a collection of JAZ tools. The problem with this stand-alone tool
  31. is, that due to how the JAZ works, not all functions are really available.
  32. The SCSI interface is a bit different than that for usual devices.
  33.  
  34. The price for the product would range from $20 to $30.
  35.  
  36. If you're interested in such a tool and would buy it, please let me know.
  37. If there is enough interest, I'll start the work. PLEASE DO NOT YET send
  38. money.
  39. _____________________________________________________________________________
  40.  
  41. Synopsis:
  42. JazTools    HANDLER=DEVICE/A,UNIT/K/N,FLAGS/K/N
  43.         SPINDOWN/K/N,PRINTSPINDOWN/S,
  44.         DISKID/S,DISKSTATUS/S,DRIVEID/S,PRINTPROTECT/S,
  45.         EJECT/S,START/S,
  46.         VERIFY/K,SELFTEST/S,PASSWORD/K,
  47.         WPROTECT/S,RWPROTECT/S,
  48.         UNPROTECT/S,TEMPUNPROTECT/S,
  49.         IOEXTEND/K,
  50.         EJECTDELAY/K/N,STARTDELAY/K/N,
  51.         FLUSHDELAY/K/N,INHIBITDELAY/K/N,
  52.         QUIET/S
  53.  
  54.  
  55. HANDLER=DEVICE/A:    Either the name of the AmigaDos device like JAZ: or
  56.             JH0: the Jaz is mounted as, with a colon at the end.
  57.             Alternatively, the name of the exec device driver
  58.             if the drive is not mounted, like "scsi.device",
  59.             "oktagon.device" or "gvpscsi.device".
  60.             If you specify the drive by its exec device driver,
  61.             you MUST give a unit as well, and the JazTools will
  62.             not check whether the device is mounted and available.
  63.  
  64. UNIT/K/N:        If the JAZ was specified by its exec device driver,
  65.             this is the SCSI Unit ID of the Jaz. 
  66.             This information is not required if you specified
  67.             the drive by its AmigaDos device name.
  68.  
  69. FLAGS/K/N:        A flags value for opening the exec device driver, 
  70.             only looked at if the JAZ was specified by its exec
  71.             driver name and ignored otherwise. This defaults to
  72.             0, and is usually not required at all. Some device
  73.             drivers check the SCSI bus again if the flags value
  74.             is set to 1 and hence might be able to detect a
  75.             JAZ which was powered on later. 
  76.  
  77. SPINDOWN/K/N:        Sets the spin-down delay for the specified unit, in
  78.             minutes. Valid numbers range from 1 to 60 minutes.
  79.             The JAZ calculates the spindown time by counting the
  80.             TEST_UNIT_READY commands, expecting one every second.
  81.             Unfortunately, the Amiga sends them more often making
  82.             a JAZ-minute approximately 50 seconds long.
  83.  
  84.             If the argument is 0, the current spindown setting
  85.             is printed.
  86.  
  87.             *This command depends on device driver internals,
  88.              the spindown time will not be set 100% correctly,
  89.                or might fail to be set at all. A true JAZ device
  90.              driver will make this working*
  91.  
  92. PRINTSPINDOWN/S:    Prints the spindown time in minutes.
  93.  
  94.  
  95. DISKID/S:        Prints unique cartridge ID. I don't know what
  96.             this could be used for.
  97.  
  98. DISKSTATUS/S:        Prints the disk life remaining, estimated by the
  99.             number of bad blocks the JazTools program finds
  100.             on the cartrigde, and the current disk status.
  101.             The first number is the amount of permanent bad
  102.             blocks, the second number is the amount of bad
  103.             blocks that could be recovered by re-formatting
  104.             the cartridge.
  105.  
  106.             *This command does not yet use the Iomega specific
  107.              commands to read the diskstatus. It might take
  108.              approximately 15min to get the information. 
  109.              I need your help to implement this correctly, see
  110.              the introduction*
  111.  
  112. DRIVEID/S:        Prints the INQUIRY information of the drive, like
  113.             the vendor and version information.
  114.  
  115. PRINTPROTECT/S:        Prints the protection status of the cartridge.
  116.  
  117. EJECT/S:        Ejects the cartridge. If the drive was specified
  118.             by its AmigaDos device name, the JazTools check
  119.             whether the device is available to AmigaDos and
  120.             fail in case it's not. Hence, if you want to
  121.             eject an unmounted cartdrige, specifiy the JAZ by
  122.             its exec device name and its SCSI ID.
  123.  
  124. START/S:        Restarts the drive in case it was parked, either
  125.             automatic or manually.
  126.  
  127. VERIFY/K:        Takes an argument, either "on" or "off". This 
  128.             *might* enable the automatic verify, at least
  129.             partially.
  130.  
  131.             *This command is not implemented 100% correctly,
  132.              it enables a verify bit in the JAZ, but does not
  133.              enforce the use of the correct write command.
  134.              Therefore, the drive might not verify as expected,
  135.              or might even do worse. A true write verify function
  136.              can't be implemented without a JAZ specific device
  137.              driver, which would adjust the write command sent
  138.              to the device according to the verify status.
  139.              Moreover, a final edition might implement a software
  140.              verify bit which might mean less stress for the
  141.              medium*
  142.  
  143. SELFTEST/S:        Only a switch. If specified, the drive runs its
  144.             selftest and reports the result on the standard
  145.             output.
  146.  
  147. PASSWORD/K:        This option provides a password, required for various
  148.             sub-options below.
  149.  
  150. WPROTECT/S:        Write-protect a medium. A password is optional.
  151.             If a password is given, the same password is 
  152.             required to unlock the medium again.
  153.  
  154. RWPROTECT/S:        Lock a medium for reading and writing. The password
  155.             is mandatory, i.e. it won't work without. 
  156.  
  157. UNPROTECT/S:        Unprotect a medium, remove the read or write 
  158.             protection. A password may or may not be required,
  159.             this depends on whether a password was given when
  160.             the volume was locked.
  161.  
  162. TEMPUNPROTECT/S:    Unprotect a medium temporarely, it will get locked
  163.             again as soon as it is removed again. Except for
  164.             that, this option is identically to UNPROTECT.
  165.  
  166. IOEXTEND/K:        Enables or disables Iomega specific functions of
  167.             the drive I've no great idea about. The argument
  168.             should be either "on" to enable them or "off" for
  169.             disabling them.
  170.  
  171.             *Currently, this shouldn't really make a difference*
  172.  
  173. EJECTDELAY/K/N:        A delay in fifties of a second ("Ticks") before the
  174.             JAZ is made available to the filing system again 
  175.             after ejection, required for the JAZ to settle down.
  176.             Defaults to 50, i.e. one second.
  177.  
  178. STARTDELAY/K/N:        Currently not yet used.
  179.  
  180. FLUSHDELAY/K/N:        A delay in fifties of a second to allow the filing
  181.             system to swap out its buffers before ejecting the
  182.             device. This is an ugly and uneffective workaround
  183.             against a bug in the FFS. (ACTION_FLUSH is not 
  184.             implemented correctly)
  185.             Defaults to 150, i.e. 3 seconds.
  186.  
  187. INHIBITDELAY/K/N:    A delay in fifties of a second after locking the
  188.             device from the filing system and before allowing
  189.             other operations, required for the filing system to
  190.             settle down.
  191.             Defaults to 100, i.e. 2 seconds.
  192.  
  193. QUIET/S:        Disables printing the copyright message.
  194. _____________________________________________________________________________
  195.  
  196. Credits:
  197.  
  198. Thanks to Werner Müller and Georges Heinesch for testing this program and
  199. for providing the necessary information by running a lot of tests.
  200. _____________________________________________________________________________
  201.  
  202.                          The THOR-Software Licence (v2, 24th June 1998)
  203.  
  204.  
  205. This License applies to the computer programs known as "JazTools". The 
  206. "Program", below, refers to such program. The "Archive" refers to the 
  207. package of distribution, as prepared by the author of the Program, 
  208. Thomas Richter. Each licensee is addressed as "you".
  209.  
  210.  
  211.  
  212. The Program and the data in the archive are freely distributable
  213. under the restrictions stated below, but are also Copyright (c)
  214. Thomas Richter.
  215.  
  216. Distribution of the Program, the Archive and the data in the Archive by a
  217. commercial organization without written permission from the author to any
  218. third party is prohibited if any payment is made in connection with such
  219. distribution, whether directly (as in payment for a copy of the Program) or
  220. indirectly (as in payment for some service related to the Program, or
  221. payment for some product or service that includes a copy of the Program
  222. "without charge"; these are only examples, and not an exhaustive enumeration
  223. of prohibited activities).
  224.  
  225.  
  226. However, the following methods of distribution
  227. involving payment shall not in and of themselves be a violation of this
  228. restriction:
  229.  
  230.  
  231. (i) Posting the Program on a public access information storage and
  232. retrieval service for which a fee is received for retrieving information
  233. (such as an on-line service), provided that the fee is not
  234. content-dependent (i.e., the fee would be the same for retrieving the same
  235. volume of information consisting of random data).
  236.  
  237.  
  238. (ii) Distributing the Program on a CD-ROM, provided that
  239.  
  240. a) the Archive is reproduced entirely and verbatim on such CD-ROM, including
  241. especially this licence agreement;
  242.  
  243. b) the CD-ROM is made available to the public for a nominal fee only,
  244.  
  245. c) a copy of the CD is made available to the author for free except for
  246. shipment costs, and
  247.  
  248. d) provided further that all information on such CD-ROM is redistributable
  249. for non-commercial purposes without charge.
  250.  
  251.  
  252. Redistribution of a modified version of the Archive, the Program or the
  253. contents of the Archive is prohibited in any way, by any organization,
  254. regardless whether commercial or non-commercial. Everything must be kept
  255. together, in original and unmodified form.
  256.  
  257.  
  258.  
  259.  
  260. Limitations.
  261.  
  262.  
  263. THE PROGRAM IS PROVIDED TO YOU "AS IS", WITHOUT WARRANTY. THERE IS NO
  264. WARRANTY FOR THE PROGRAM, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT
  265. LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
  266. PARTICULAR PURPOSE AND NONINFRINGEMENT OF THIRD PARTY RIGHTS. THE ENTIRE
  267. RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD
  268. THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY
  269. SERVICING, REPAIR OR CORRECTION.
  270.  
  271.  
  272. IF YOU DO NOT ACCEPT THIS LICENCE, YOU MUST DELETE THE PROGRAM, THE ARCHIVE
  273. AND ALL DATA OF THIS ARCHIVE FROM YOUR STORAGE SYSTEM. YOU ACCEPT THIS
  274. LICENCE BY USING OR REDISTRIBUTING THE PROGRAM.
  275.  
  276.  
  277.                                                         Thomas Richter
  278.  
  279. _____________________________________________________________________________
  280.  
  281. Thomas,        
  282.     September 1999
  283.  
  284.  
  285. ============================= Archive contents =============================
  286.  
  287. Original  Packed Ratio    Date     Time    Name
  288. -------- ------- ----- --------- --------  -------------
  289.    19280   10701 44.4% 02-Oct-99 22:19:32 +JazTools
  290.    10983    4528 58.7% 02-Oct-99 22:21:18 +JazTools.readme
  291. -------- ------- ----- --------- --------
  292.    30263   15229 49.6% 14-Oct-99 21:11:44   2 files
  293.